home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / biblio / bibtex / contrib / bibtex.ins < prev    next >
Text File  |  1988-09-25  |  2KB  |  53 lines
  1. To get BibTeX running you should: make sure you have all files listed
  2. below, read the overview section (the first page) of BTXDOC.TEX, and
  3. (if needed) create or procure a BibTeX change file for your system so
  4. you can Tangle and compile BibTeX.  To test your implementation,
  5. follow these simple steps (note: in what follows, the word `match' is
  6. used loosely, because lines longer than 80 characters have been
  7. broken manually in BTXDOC.AUX; thus, your system's file-compare
  8. program may say the files are different even though they match):
  9.  
  10. (A) Run BTXDOC.TEX through LaTeX. You'll get a bunch of LaTeX warning
  11. messages, and LaTeX will produce a BTXDOC.AUX file that will NOT match
  12. the supplied file of that name.  NOTE: Don't let LaTeX "see" a copy of
  13. the supplied BTXDOC.AUX or BTXDOC.BBL during this run.
  14.  
  15. (B) Run BibTeX on the BTXDOC.AUX file created in step (A).  BibTeX
  16. will read in the supplied file BTXDOC.BIB.  This run should produce
  17. a BTXDOC.BBL file that matches the suppled file of the same name;
  18. BibTeX will give one warning message (about chicago).
  19.  
  20. (C) Run BTXDOC.TEX through LaTeX.  Again, you'll get some LaTeX
  21. warning messages, but this time LaTeX will produce a new BTXDOC.AUX
  22. file that DOES match the supplied file of that name.  This run will
  23. read in the BTXDOC.AUX file produced in (A) and the BTXDOC.BBL file
  24. produced in step (B).
  25.  
  26. (D) Run BTXDOC.TEX through LaTeX.  By reading the new BTXDOC.AUX file,
  27. LaTeX will produce no warning messages, and you should get another
  28. matching copy of the BTXDOC.AUX file.
  29.  
  30. IMPORTANT NOTE: After you get BibTeX running you should make sure that
  31. all the documentation files listed below are available on your system,
  32. and you should state in the _Local Guide_ exactly how to access them.
  33.  
  34. Here are BibTeX-related files in this directory:
  35.  
  36.  
  37. BIBTEX.INS    this file
  38. BIBTEX.WEB    the WEB source file for BibTeX
  39. BTXDOC.TEX    documentation, and also sample input for BibTeX implementors
  40. BTXHAK.TEX    documentation for style designers
  41. BTXDOC.BIB    the bibliography database file for BTXDOC.TEX
  42. BTXDOC.BBL    a file for comparing your implementation's output
  43. BTXDOC.AUX    another
  44. XAMPL.BIB    a database file with an example of every standard entry type
  45.  
  46.  
  47. BTXBST.DOC    the documentation and template for the four standard
  48.           bibliography styles:
  49. ABBRV.BST    abbreviated
  50. ALPHA.BST    alphabetic
  51. PLAIN.BST    plain
  52. UNSRT.BST    unsorted
  53.